Repository navigation
Declare the site's live preview (saas-parallel-baselining PB4) - #4
Merged
Merged
Conversation
orun.work's Preview tab shows a coding session's dev server, live from its
box: `orun preview` (orun v2.96.0) runs what a repository declares, and the
session keeps it running while it works.
- apps/web/component.yaml: spec.preview. It installs this app's packages
only (--filter "@app/web..."), then runs `next dev` alone on
127.0.0.1:3000, with a 1 GiB heap cap; the tab opens /. It is the app's
own `pnpm dev`: its pages need the local Postgres that wrangler.jsonc's
Hyperdrive localConnectionString names (localhost:54322) for the session
key, and show Next's error page until one is up.
- intent.yaml: preview: {component: web}.
- apps/web/next.config.mjs: allowedDevOrigins for the preview's hosts
(*.orun-preview.app, preview-gateway-stage.oruncloud.workers.dev); Next 16
refuses the hot reload's WebSocket from an origin it is not told about.
And, in `next dev` only (NODE_ENV=development), the same hosts as Server
Actions origins, which Next refuses from an Origin that is not the Host.
`next build` reads neither.
- baseline.yml: orun v2.88.0 -> v2.96.0, the first release that reads
spec.preview, so the placement's `orun validate` checks it. ci.yml (the
product's own lane pin) is unchanged.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019PcpNV6SjymJBPv3nNkC4z
ruehowl
marked this pull request as ready for review
November 4, 2026 21:09
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The baseline declares its live preview, so orun.work's Preview tab can show a coding session's dev server (saas-parallel-baselining PB4).
apps/web/component.yaml:spec.preview:intent.yaml:preview: {component: web}.apps/web/next.config.mjs:allowedDevOrigins: ["*.orun-preview.app", "preview-gateway-stage.oruncloud.workers.dev"]. The gateway gives the dev server a localHostbut passes the browser'sOriginthrough, and Next 16 refuses the hot reload's WebSocket from an unlisted origin (Unauthorized). Onlynext devreads this setting.apps/web/next.config.mjs, insideexperimental:serverActions.allowedOriginsfor the same two hosts, only whenNODE_ENV === "development"(next dev). Behind the gateway a Server Action'sOriginis the preview's host whilenext devseesHost: 127.0.0.1:3000, and Next refuses it ("Invalid Server Actions request").next buildruns withNODE_ENV=production, so the deployed Worker keeps its same-origin check..github/workflows/baseline.yml: orunv2.88.0→v2.96.0, the first release that readsspec.preview, so the placement test'sorun validatechecks the declaration.ci.yml(the product's own lane pin,v2.78.4) is unchanged.Nothing about how the baseline builds or deploys changes.
Checked
From a clean clone, with orun v2.96.0, and through a local stand-in of the preview gateway (the dev server sees a local
Hostand the browser's ownOrigin; the page is framed from a foreign origin):orun validateorun preview start --jsonreadyin 10.0 s (warm pnpm store)GET /Host+Originstraight to the dev serverorun preview stopConsole errors in the frame: Failed to load resource: the server responded with a status of 500 (Internal Server Error); pageerror: connect ECONNREFUSED 127.0.0.1:54322
Notes
pnpm devdoes: the proxy is Auth.js'sauth, whose secret comes from Postgres (lib/auth-secret.ts; noAUTH_SECRET, and nothing secret inenv). The preview starts no database, so in a box with none onlocalhost:54322(wrangler.jsonc's HyperdrivelocalConnectionString) the tab shows Next's error page (connect ECONNREFUSED 127.0.0.1:54322, the 500s above) with the hot-reload socket connected; a session that starts Postgres there and applies the migrations gets the dashboard. Not exercised with a database here. GitHub sign-in also needs the OAuth App's ID and secret, which are Orun secrets.next devof another Next 16.3 baseline that has actions (sourceplane/subscription-payments):https://abc123def456.orun-preview.appand the stage gateway host pass Next's origin check (404, action not found),https://elsewhere.example.comis refused (500, "Invalid Server Actions request").next-server~0.9 GB with the error page compiled, plus the Cloudflare platform proxy (initOpenNextCloudflareForDev) and workers, ~1.2 GB in all.gen-component-docs.py --check.next devwritesapps/web/AGENTS.mdandCLAUDE.md(its own agent rules) on startup, as it does for anynext dev; this PR leaves that alone.https://claude.ai/code/session_019PcpNV6SjymJBPv3nNkC4z
Generated by Claude Code